<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>Property Pane</title>
<link href="../../book.css" rel="stylesheet" type="text/css">
</head>

<body>
<h1>Property Pane</h1>
<table border="0" width="800" cellspacing="0" cellpadding="0">
	<tr>
		<td valign="top">
			<img src="images/property_pane.png" alt="" border="0" hspace="0" vspace="5"></td>
		<td valign="top" width="10">
			&nbsp;</td>
		<td valign="top">
			<p>The <b>Property Pane </b>displays properties and events of the selected 
			components and 
provides editable text fields, lists and other controls to allow you to edit 
properties and <a href="../features/event_handling.html">events</a>. Select the control in the <b>
	<a href="component_tree.html">Component Tree</a></b> or on the <b>
			<a href="design_view.html">Design View</a></b> to display its properties in the <b>Property Pane</b>.&nbsp; Once 
visible in the <b>Property Pane</b>, these values can be edited. </p>
			<p>When
multiple controls are selected, all of their shared properties are listed in
the <b>Property Pane</b>.<span style="mso-spacerun: yes"> </span>If not all the selected
controls have the same value for a property, the property editor in the
			<b>Property Pane </b>will be blank.</p>
			<p>By default, the <b>Property Pane </b>displays normal properties. 
			Preferred properties are shown in <b>bold</b> and expert properties 
			are shown in <i>italics</i> (click the <b>Show advanced properties
			</b>
			<img border="0" src="images/filter_advanced_properties.gif" width="16" height="16"> 
			button to reveal them). A gray background indicates a property set 
			to its default value while a white background indicates a property 
			that has been set to a non-default value. Click the <b>Restore 
			default value </b>
			<img border="0" src="images/properties_default.gif" width="16" height="16"> 
			button to set a property back to its default value.</p>
			<p>You can select a property by clicking on the property title or value. When 
a property is selected, an editor is displayed instead of the value, so you can 
change it value. In most property editors <b>Enter</b> should be used to apply the 
value, and <b>Esc</b> to return to the previous value. If you select some property, you 
can use the arrow keys to navigate between properties. </p>
			<p>The <b>Property Pane </b>supports simple properties such as Strings and ints and complex 
properties that consist of several other properties, such as layouts and 
layout datas. Complex properties are displayed with a plus or minus sign before 
the title. You can expand/collapse complex properties in several different ways:</p>
			<ul>
				<li>
				<p style="margin-bottom: 6">double click on the property title 
				or value</li>
				<li>
				<p style="margin-bottom: 6">single click on plus or minus sign</li>
				<li>
				<p style="margin-bottom: 6">select property and press 
			<img border="0" src="images/plus.png" align="middle" width="18" height="18"> to expand, 
			<img border="0" src="images/minus.png" align="middle" width="18" height="18"> to 
	collapse</li>
			</ul>
			</td>
	</tr>
	<tr>
		<td valign="top" colspan="3">
<p>Some properties, such as
			<a href="property_editor_string.html">strings</a>,
			<a href="property_editor_color.html">colors</a>,
			<a href="property_editor_font.html">fonts</a> and
			<a href="property_editor_image.html">images</a>, provide a custom 
			property editor which can be access by clicking the
			<img border="0" src="images/ellipses.png" align="absbottom"> button.</p>
<p>The state of a property (expanded or collapsed) is preserved between 
selections of controls, so if you expand the property &#8220;style&#8221; for one control and 
then select another control, the property &#8220;style&#8221; will remain expanded, so you will able 
to quickly change the style value for several properties without needing to 
expand it again and again. Once you decide, that you don&#8217;t need to change the 
style, you can collapse the property &#8220;style&#8221; and save space for other 
properties.</p>
			<p>
			<img src="images/property_pane_context_menu.png" alt="" border="0" hspace="10" align="right">The <b>Property Pane </b>supports selection properties, i.e. properties, whose values 
should be selected from some list. For example &#8220;type&#8221; property of complex 
&#8220;style&#8221; property for Buttons is such a property. You can change its 
value in the following ways: </p>
<ul>
  <li>
  <p style="margin-bottom: 6">
			double click on the property value or for changing 
  value to next value in list (or first value, if current value is the last);
  </li>
  <li>
  <p style="margin-bottom: 6">select property and press Space to expand list and 
	then use arrows to change value; </li>
  <li>
  <p style="margin-bottom: 6">select property and press <b>Delete</b> to change value to 
  default. </li>
</ul>
		<p style="margin-bottom: 6">Right-click on the <b>Property Pane</b> to 
		access the <a href="property_pane_context_menu.html">property pane 
		context menu</a>.</td>
	</tr>
</table>
      


</body></html>
